<html><head>
      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
   <title>JAXB Release Documentation</title><link rel="stylesheet" href="style/documentation.css" type="text/css"><meta name="generator" content="DocBook XSL-NS Stylesheets V1.75.2"><link rel="home" href="index.html" title="JAXB Release Documentation"><link rel="next" href="ch01.html" title="Overview"><script xmlns:fo="http://www.w3.org/1999/XSL/Format" type="text/javascript">
  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-2105126-1']);
  _gaq.push(['_trackPageview']);

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();
</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">JAXB Release Documentation</th></tr><tr><td width="20%" align="left">&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr></div><small xmlns:fo="http://www.w3.org/1999/XSL/Format" class="small">Links: <a href="index.html">Table of Contents</a> | <a href="release-documentation.html">Single HTML</a> | <a href="release-documentation.pdf">Single PDF</a></small><div lang="en" class="book" title="JAXB Release Documentation" id="release-documentation"><div class="titlepage"><div><div><h1 class="title">JAXB Release Documentation</h1></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ch01.html">Overview</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#documentation">1. Documentation</a></span></dt><dt><span class="section"><a href="ch01.html#license">2. Software Licenses</a></span></dt><dt><span class="section"><a href="ch01.html#jaxb-2-0-sample-apps">3. Sample Apps</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#section-3589085759105448">3.1. Using the Runtime Binding Framework</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch02.html">Release Notes</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#section-2232462900667844">1. <span class="trademark">Java</span>&#8482; 2 Platform, Standard Edition (<span class="trademark">J2SE</span>&#8482;)
        Requirements</a></span></dt><dt><span class="section"><a href="ch02.html#jars">2. Identifying the JAR Files</a></span></dt><dt><span class="section"><a href="ch02.html#section-141747963608015">3. Locating the Normative Binding Schema</a></span></dt><dt><span class="section"><a href="ch02.html#jaxb-2-0-changelog">4. Changelog</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#a-2-2-7">4.1. Changes between 2.2.6 to 2.2.7</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-6">4.2. Changes between 2.2.5-2 to 2.2.6</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-5u2">4.3. Changes between 2.2.5-1 to 2.2.5-2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-5u1">4.4. Changes between 2.2.5 to 2.2.5-1</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-5">4.5. Changes between 2.2.4-1 to 2.2.5</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-4u1">4.6. Changes between 2.2.4 to 2.2.4-1</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-4">4.7. Changes between 2.2.3u2 to 2.2.4</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-3u2">4.8. Notable Changes between 2.2.3u1 to 2.2.3u2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-3u1">4.9. Notable Changes between 2.2.3 to 2.2.3u1</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-3">4.10. Notable Changes between 2.2.2 to 2.2.3</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-2">4.11. Notable Changes between 2.2.1.1 to 2.2.2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-1-1">4.12. Notable Changes between 2.2.1 to 2.2.1.1</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2-1">4.13. Notable Changes between 2.2 to 2.2.1</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-2">4.14. Notable Changes between 2.1.12 to 2.2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-13">4.15. Notable Changes between 2.1.12 to 2.1.13</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-12">4.16. Notable Changes between 2.1.11 to 2.1.12</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-11">4.17. Notable Changes between 2.1.10 to 2.1.11</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-10">4.18. Notable Changes between 2.1.9 to 2.1.10</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-9">4.19. Notable Changes between 2.1.8 to 2.1.9</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-8">4.20. Notable Changes between 2.1.7 to 2.1.8</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-7">4.21. Notable Changes between 2.1.6 to 2.1.7</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-6">4.22. Notable Changes between 2.1.5 to 2.1.6</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-5">4.23. Notable Changes between 2.1.4 to 2.1.5</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-4">4.24. Notable Changes between 2.1.3 to 2.1.4</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-3">4.25. Notable Changes between 2.1.2 to 2.1.3</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-2">4.26. Notable Changes between 2.1.1 to 2.1.2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1-1">4.27. Notable Changes between 2.1 First Customer Ship (FCS) to
  2.1.1</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1">4.28. Notable Changes between 2.1 Eary Access 2 to 2.1 First
  Customer Ship (FCS)</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1ea2">4.29. Notable Changes between 2.1 Eary Access to 2.1 Early Access
  2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-1ea">4.30. Notable Changes between 2.0.2 to 2.1 Early Access</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-0-3">4.31. Notable Changes between 2.0.2 to 2.0.3</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-0-2">4.32. Notable Changes between 2.0.1 to 2.0.2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-0-1">4.33. Notable Changes between 2.0 to 2.0.1</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-0">4.34. Notable Changes between 2.0 Early Access 3 and 2.0 First
  Customer Ship (FCS)</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-0ea3">4.35. Notable Changes between 2.0 Early Access 2 and 2.0 Early
  Access 3</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-0ea2">4.36. Notable Changes between 2.0 Early Access and 2.0 Early Access
  2</a></span></dt><dt><span class="section"><a href="ch02.html#a-2-0ea">4.37. Notable Changes between 1.0.x FCS and 2.0 Early Access</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch03.html">JAXB Users Guide</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#compiling-xml-schema">1. Compiling XML Schema</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#compiling-xml-schema-dealing-with-errors">1.1. Dealing with errors</a></span></dt><dt><span class="section"><a href="ch03.html#compiling-xml-schema-fixing-broken-references-in-schema">1.2. Fixing broken references in schema</a></span></dt><dt><span class="section"><a href="ch03.html#compiling-xml-schema-mapping-of-xs-any">1.3. Mapping of <code class="literal">&lt;xs:any /&gt;</code></a></span></dt><dt><span class="section"><a href="ch03.html#compiling-xml-schema-mapping-of-xs-element-to-jaxbelement">1.4. Mapping of <code class="literal">&lt;xs:element /&gt;</code> to JAXBElement</a></span></dt><dt><span class="section"><a href="ch03.html#compiling-xml-schema-how-modularization-of-schema-interacts-with-xjc">1.5. How modularization of schema interacts with XJC</a></span></dt><dt><span class="section"><a href="ch03.html#compiling-xml-schema-adding-behaviors">1.6. Adding behaviors</a></span></dt><dt><span class="section"><a href="ch03.html#compiling-xml-schema-avoid-strong-databinding">1.7. Avoid strong databinding</a></span></dt><dt><span class="section"><a href="ch03.html#compiling-xml-schema-working-with-generated-code-in-memory">1.8. Working with generated code in memory</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#customization-of-schema-compilation">2. Customization of Schema Compilation</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#customization-of-schema-compilation-customizing-java-packages">2.1. Customizing Java packages</a></span></dt><dt><span class="section"><a href="ch03.html#customization-of-schema-compilation-using-scd-for-customizations">2.2. Using SCD for customizations</a></span></dt><dt><span class="section"><a href="ch03.html#customization-of-schema-compilation-using-different-datatypes">2.3. Using different datatypes</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#annotating-your-classes">3. Annotating Your Classes</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#annotating-your-classes-mapping-your-favorite-class">3.1. Mapping your favorite class</a></span></dt><dt><span class="section"><a href="ch03.html#annotating-your-classes-mapping-interfaces">3.2. Mapping interfaces</a></span></dt><dt><span class="section"><a href="ch03.html#annotating-your-classes-evolving-annotated-classes">3.3. Evolving annotated classes</a></span></dt><dt><span class="section"><a href="ch03.html#annotating-your-classes-xml-layout-and-in-memory-data-layout">3.4. XML layout and in-memory data layout</a></span></dt><dt><span class="section"><a href="ch03.html#annotating-your-classes-mapping-cyclic-references-to-xml">3.5. Mapping cyclic references to XML</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#unmarshalling">4. Unmarshalling</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#unmarshalling-xmlrootelement-and-unmarshalling">4.1. <code class="literal">@XmlRootElement</code> and unmarshalling</a></span></dt><dt><span class="section"><a href="ch03.html#unmarshalling-unmarshalling-is-not-working-help">4.2. Unmarshalling is not working! Help!</a></span></dt><dt><span class="section"><a href="ch03.html#unmarshalling-element-default-values-and-unmarshalling">4.3. Element default values and unmarshalling</a></span></dt><dt><span class="section"><a href="ch03.html#unmarshalling-dealing-with-large-documents">4.4. Dealing with large documents</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#marshalling">5. Marshalling</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#marshalling-changing-prefixes">5.1. Changing prefixes</a></span></dt><dt><span class="section"><a href="ch03.html#marshalling-element-default-values-and-marshalling">5.2. Element default values and marshalling</a></span></dt><dt><span class="section"><a href="ch03.html#marshalling-different-ways-of-marshalling">5.3. Different ways of marshalling</a></span></dt><dt><span class="section"><a href="ch03.html#marshalling-interaction-between-marshalling-and-dom">5.4. Interaction between marshalling and DOM</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#schema-generation">6. Schema Generation</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#schema-generation-invoking-schemagen-programatically">6.1. Invoking schemagen programatically</a></span></dt><dt><span class="section"><a href="ch03.html#schema-generation-generating-schema-that-you-want">6.2. Generating Schema that you want</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#deployment">7. Deployment</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#deployment-migrating-jaxb-2-0-applications-to-javase-6">7.1. Migrating JAXB 2.0 applications to JavaSE 6</a></span></dt><dt><span class="section"><a href="ch03.html#deployment-which-jaxb-ri-is-included-in-which-jdk">7.2. Which JAXB RI is included in which JDK?</a></span></dt><dt><span class="section"><a href="ch03.html#deployment-running-jaxb-1-0-and-2-x-side-by-side">7.3. Running JAXB 1.0 and 2.x side by side</a></span></dt><dt><span class="section"><a href="ch03.html#deployment-migrating-jaxb-1-0-applications-to-jaxb-2-x">7.4. Migrating JAXB 1.0 applications to JAXB 2.x</a></span></dt><dt><span class="section"><a href="ch03.html#deployment-runtime-errors">7.5. Runtime Errors</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#other-miscellaneous-topics">8. Other Miscellaneous Topics</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#other-miscellaneous-topics-performance-and-thread-safety">8.1. Performance and thread-safety</a></span></dt><dt><span class="section"><a href="ch03.html#other-miscellaneous-topics-compiling-dtd">8.2. Compiling DTD</a></span></dt><dt><span class="section"><a href="ch03.html#other-miscellaneous-topics-using-jaxb-from-maven">8.3. Using JAXB from Maven</a></span></dt><dt><span class="section"><a href="ch03.html#other-miscellaneous-topics-designing-a-client-server-protocol-in-xml">8.4. Designing a client/server protocol in XML</a></span></dt><dt><span class="section"><a href="ch03.html#other-miscellaneous-topics-contributing-to-this-guide">8.5. Contributing to this Guide</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch04.html">Tools</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#tools-xjc">1. XJC</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#d0e4286">1.1. <span class="command"><strong>xjc</strong></span> Overview</a></span></dt><dt><span class="section"><a href="ch04.html#section-7316528525821393">1.2. Launching <span class="command"><strong>xjc</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#d0e4358">1.3. <span class="command"><strong>xjc</strong></span> Syntax</a></span></dt><dt><span class="section"><a href="ch04.html#restrictions">1.4. Compiler Restrictions</a></span></dt><dt><span class="section"><a href="ch04.html#xjcresources">1.5. Generated Resource Files</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-xjc-ant-task">2. XJC Ant Task</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#d0e4733">2.1. <span class="command"><strong>xjc</strong></span> Task Overview</a></span></dt><dt><span class="section"><a href="ch04.html#section-356252324237826">2.2. <span class="command"><strong>xjc</strong></span> Task Attributes</a></span></dt><dt><span class="section"><a href="ch04.html#section-837075444051632">2.3. Generated Resource Files</a></span></dt><dt><span class="section"><a href="ch04.html#section-767416326934949">2.4. Up-to-date Check</a></span></dt><dt><span class="section"><a href="ch04.html#section-31739621133682">2.5. Schema Language Support</a></span></dt><dt><span class="section"><a href="ch04.html#section-607840891098334">2.6. <span class="command"><strong>xjc</strong></span> Examples</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-schemagen">3. SchemaGen</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#d0e5291">3.1. <span class="command"><strong>schemagen</strong></span> Overview</a></span></dt><dt><span class="section"><a href="ch04.html#section-182504251480881">3.2. Launching <span class="command"><strong>schemagen</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#d0e5336">3.3. <span class="command"><strong>schemagen</strong></span> Syntax</a></span></dt><dt><span class="section"><a href="ch04.html#section-906211973953818">3.4. Generated Resource Files</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-schemagen-ant-task">4. SchemaGen Ant Task</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#d0e5374">4.1. <span class="command"><strong>schemagen</strong></span> Task Overview</a></span></dt><dt><span class="section"><a href="ch04.html#section-417846742205862">4.2. <span class="command"><strong>schemagen</strong></span> Task Attributes</a></span></dt><dt><span class="section"><a href="ch04.html#section-9298229576523986">4.3. <span class="command"><strong>schemagen</strong></span> Examples</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-3rd-party-tools">5. 3rd Party Tools</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#section-954928396024079">5.1. Maven JAXB Plugin</a></span></dt><dt><span class="section"><a href="ch04.html#section-2873137906334116">5.2. JAXB Workshop</a></span></dt><dt><span class="section"><a href="ch04.html#section-2642114715432213">5.3. XJC Plugins</a></span></dt><dt><span class="section"><a href="ch04.html#section-926973453240119">5.4. RDBMS Persistence</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch05.html">JAXB RI Extensions</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#jaxb-ri-extensions-overview">1. Overview</a></span></dt><dt><span class="section"><a href="ch05.html#jaxb-ri-extensions-runtime-properties">2. Runtime Properties</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#section-872160760955562">2.1. Marshaller Properties</a></span></dt></dl></dd><dt><span class="section"><a href="ch05.html#jaxb-ri-extensions-xjc-customizations">3. XJC Customizations</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#section-3752096477276927">3.1. Customizations</a></span></dt></dl></dd><dt><span class="section"><a href="ch05.html#jaxb-ri-extensions-dtd">4. DTD</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#section-117866877581027">4.1. DTD</a></span></dt></dl></dd><dt><span class="section"><a href="ch05.html#jaxb-ri-extensions-develop-plugins">5. Develop Plugins</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#section-5151430285858327">5.1. What Can A Plugin Do?</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch06.html">Frequently Asked Questions</a></span></dt><dt><span class="chapter"><a href="ch07.html">Related Articles</a></span></dt><dd><dl><dt><span class="section"><a href="ch07.html#d0e6587">1. Introductory</a></span></dt><dt><span class="section"><a href="ch07.html#d0e6603">2. Blogs</a></span></dt><dt><span class="section"><a href="ch07.html#d0e6623">3. Interesting articles</a></span></dt></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right" valign="top">&nbsp;Overview</td></tr></table></div></body></html>